home *** CD-ROM | disk | FTP | other *** search
/ Java Programmer's Toolkit / Java Programmer's Toolkit.iso / postscpt / viewer / readme.gv < prev    next >
Text File  |  1996-01-10  |  9KB  |  232 lines
  1. ===============================================================
  2. README.GV         1996-01-10
  3. ===============================================================
  4. GSview 1.4 - PostScript previewer.  Needs Ghostscript 3.53.
  5.  
  6. ========
  7. Overview
  8. ========
  9. PM GSview is a graphical interface for OS/2 Ghostscript.
  10. GSview for Windows is a graphical interface for MS-Windows Ghostscript.
  11. Ghostscript is an interpreter for the PostScript page description language 
  12. used by laser printers.
  13. For documents following the Adobe PostScript Document Structuring 
  14. Conventions, GSview allows selected pages to be viewed or printed.
  15. Ghostscript is required, preferably version 3.33 or later.  
  16.  
  17. Features include:
  18.  - view pages in arbitrary order (Next, Previous, Goto).
  19.  - selectable display resolution.
  20.  - page size is automatically selected from DSC comments.
  21.  - page size can be selected using the menu.
  22.  - orientation is automatically selected from DSC comments.
  23.  - orientation can be selected using the menu (Portrait, Landscape).
  24.  - print selected pages using Ghostscript.
  25.  - extract selected pages to another file.
  26.  - copy display bitmap to clipboard.
  27.  - save clipboard bitmap as BMP file.
  28.  - add bitmap preview to EPS file (Interchange, TIFF or Windows Metafile)
  29.  - graphically select bounding box for EPS file.
  30.  - extract bitmap preview or postscript from DOS EPS file.
  31.  - on-line help.
  32.  - free (GSview Free Public Licence).
  33. New features in version 1.1:
  34.  - Works with Ghostscript 3.0 (Level 2 PostScript)
  35.  - PM GSview (OS/2).
  36.  - GSview for Windows Win32s.
  37.  - change display depth (bits/pixel).
  38.  - added option to ignore DSC comments.
  39.  - zoom with right mouse button.
  40.  - buttons to change resolution by 1.2 or 1/1.2.
  41.  - cursor position displayed in pt, mm or inch.
  42.  - extract text from postscript.
  43.  - find text.
  44. New features in version 1.2:
  45.  - Works under Windows NT 3.5.
  46.  - Draw bounding box over image (OS/2 only).
  47.  - Works with GS 2.6.1 under MS-Windows, but not recommended.
  48. New features in version 1.3:
  49.  - Display PDF files (OS/2 only).
  50.  - Works under Windows 95 (see gvcbugs.doc)
  51.  - Smaller text in Windows Dialog boxes.
  52. New features in version 1.4:
  53.  - Installation program (os2setup, winsetup).
  54.  - Uses print queues under OS/2 and Win95/NT.
  55.  - Uses gs16spl to talk to 16-bit print queue from Win32s.
  56.  - Add user supplied preview (usually WMF) to EPS file.
  57.  - Page Offset for printing
  58.  
  59. PM GSview and GSview for Windows were written by Russell Lang.
  60.  
  61. ============
  62. Installation
  63. ============
  64. Create four 1.44M floppies containing the following files, or
  65. put them all in the same directory on your hard disk.
  66.  
  67. Disk 1:
  68.   gsview.zip
  69.   README.GV
  70.   FILE_ID.DIZ
  71.   os2setup.exe      OS/2 installation program
  72.   os2unzip.exe      OS/2 INFO-ZIP unzip utility
  73.   winsetup.exe      MS-Windows installation program
  74.   winunzip.exe      MS-Windows INFO-ZIP unzip utility
  75.   emxrt.zip         EMX Run Time library for OS/2.
  76.  
  77. Disk 2:
  78.   gs353ini.zip      Aladdin Ghostscript library files
  79.   gs353dos.zip      MS-DOS 386 Aladdin Ghostscript
  80.  
  81. Disk 3:
  82.   gs353os2.zip      OS/2 Aladdin Ghostscript
  83.   gs353w32.zip      MS-Windows Win32 Aladdin Ghostscript
  84.   gs353win.zip      MS-Windows 3.1 Aladdin Ghostscript
  85.  
  86. Disk 4:
  87.   gs353fn1.zip      Aladdin Ghostscript fonts.
  88.  
  89. Disk 1 is the contents of gsview14.zip plus the file emxrt.zip obtained
  90. from ftp://ftp-os2.nmsu.edu/os2/unix/emx09b/emxrt.zip.
  91. Disks 2 to 4 are obtained from ftp://ftp.cs.wisc.edu/ghost/aladdin/
  92.  
  93. If using the floppy install method, 7Mbytes of hard disk space is required.
  94.  
  95. To install from OS/2, run 'os2setup.exe' from disk 1.
  96. To install from MS-Windows, run 'winsetup.exe' from disk 1.
  97. The installation will overwrite any version of GSview or
  98. Aladdin Ghostscript in the destination directories.  If you
  99. wish to save your Fontmap file, back it up to another directory.
  100. Make sure that the zip files are transferred in binary mode and
  101. are all present.  The install program will not report bad zip files.
  102.  
  103. If you don't like automatic installation programs, it is 
  104. possible to install GSview and Ghostscript manually.  See
  105. the Setup topic below for more details.
  106.  
  107. ===========
  108. Compilation
  109. ===========
  110. To compile PM GSview you need IBM NMAKE.EXE and EMX/GCC 0.9b
  111. with emxfix01 or later.
  112. To create the PM GSview online help you need the IBM toolkit.
  113. Copy gvpm.mak to Makefile and edit COMPBASE and EMXPATH as required.
  114. Type 'nmake'
  115.  
  116. To compile GSview for Windows you need Borland C++ 3.1 or 4.5.
  117. To compile GSview for Windows Win32s you need Borland C++ 4.5.
  118. Copy gvwin.mak to Makefile then edit COMPBASE and WIN32 as required.
  119. Type 'make'.
  120.  
  121. =====
  122. Setup
  123. =====
  124. Copy gvpm.exe, gvpm.hlp, gsview.exe, gsview32.exe, gsview.hlp 
  125. and gsv16spl.exe to the Ghostscript directory.  
  126. Start GSview then select "Options | Configure Ghostscript",
  127. and enter the correct executable and include paths for Ghostscript.
  128. For example:
  129.   c:\gs\gsos2.exe
  130.   c:\gs;c:\psfonts
  131.  
  132. PM GSview will run under OS/2 2.1 and OS/2 Warp.  
  133. It may run under OS/2 2.0.
  134. PM GSview has been compiled with EMX/GCC 0.9b and requires
  135. the emx 0.9b DLL's.  These are available from
  136.   ftp://hobbes.nmsu.edu/os2/unix/emx09b/emxrt.zip
  137.  
  138. GSview for Windows will run under Windows 3.1.
  139. GSview will probably run under Windows 3.0, but you need a special
  140. version of commdlg.dll, shell.dll and winhelp.exe.  This version has never 
  141. been tested with Windows 3.0.  If it works at all consider yourself lucky.
  142.  
  143. gsview32.exe will work with Ghostscript under Windows 3.1/Win32s, 
  144. Windows NT 3.5 or Windows 95, but may have a few problems with the 
  145. latter two.
  146.  
  147. See the on-line help for more details.
  148. The 'Common Problems' topic is worth reading if GSview won't work.
  149.  
  150. ====
  151. Bugs
  152. ====
  153. Send bug reports to Russell Lang <rjl@aladdin.com>.
  154. (This is an alias provided by Aladdin Enterprises.  Russell Lang is not 
  155. an employee or agent of Aladdin Enterprises).
  156. When reporting bugs, please include the version number and date of 
  157. GSview (from the Help | About box), the version number of Ghostscript, 
  158. and the exact wording of any error messages.  Ghostscript error
  159. messages can be copied to the clipboard using the system menu of
  160. the Ghostscript text window.
  161. Do not send me large files unless requested.
  162. If you get a SYS3175 or GPF, please send the address of the GPF - I can 
  163. use this to help locate the bug.
  164. Please distinguish between bugs in GSview and bugs in Ghostscript.
  165. Don't expect a fast response - the work I'm paid to do has a higher
  166. priority.
  167.  
  168. =======
  169. Updates
  170. =======
  171. The latest version of PM GSview and GSview for Windows should 
  172. be available from
  173.   ftp://ftp.cs.wisc.edu/ghost/rjl/gsview*.zip
  174. or by mail (see next section).
  175.  
  176. A World Wide Web home page for Ghostscript, Ghostview and GSview is at
  177.   http://www.cs.wisc.edu/~ghost/index.html
  178.  
  179. ==================================
  180. Copyright, Licensing and Donations
  181. ==================================
  182. GSview is copyright by Russell Lang.
  183. GSview is distributed with the GSview Free Public Licence.
  184. This licence is contained in the file LICENCE.
  185. The GSview Free Public Licence does not require any payment to the author;
  186. however the author would welcome any donations to cover costs and time
  187. involved in developing and maintaining GSview.  These may be sent to
  188.     Russell Lang
  189.     12 Princetown Road
  190.     MOUNT WAVERLEY  VIC  3149
  191.     AUSTRALIA
  192. Donations are preferred in Australian dollars because it costs AUS$5
  193. to bank an overseas currency cheque.
  194. If the donation is over AUS$40 or US$40 then the author will mail 
  195. the next update to you on a 3.5" HD disk (it won't fit on my 5.25" DD),
  196. provided you supply the information below.
  197. Updates are not likely to be frequent.
  198. Please accompany donations with the following information:
  199.     Your name.
  200.     Your postal address.
  201.     Your email address (if you have one).
  202.     Version number of GSview.
  203.     Where you obtained or heard about GSview.
  204.     Version number of Ghostscript.
  205.     Donation amount and currency.
  206.     Do you want updates to be mailed to you on disk?
  207.  
  208. The ps.c module is copyright by Tim Theisen and is covered by the
  209. licence in the file PUBLIC.
  210.  
  211. GSview uses Ghostscript to display the contents of the PostScript
  212. files.  Ghostscript is a separate program from GSview; it is
  213. written and owned by Aladdin Enterprises, not by Russell Lang.
  214.  
  215. Aladdin Ghostscript comes with a licence that is more restrictive than 
  216. the GNU Licence; in particular, it restricts the distribution of
  217. Aladdin Ghostscript in commercial contexts.  Please see the file PUBLIC
  218. that accompanies Aladdin Ghostscript for more details.
  219.  
  220. ================
  221. Acknowledgements
  222. ================
  223. Tim Theisen, who wrote Ghostview for X11 which provided the inspiration
  224. for PM GSview and GSview for Windows.  Also for permission to use his
  225. ps.c module from Ghostview.
  226.  
  227. L. Peter Deutsch, for writing Ghostscript and for making changes to 
  228. Ghostscript to support GSview for Windows.
  229.  
  230.  
  231. ==============================================================
  232.